home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat1 / pmprobe.z / pmprobe
Encoding:
Text File  |  2001-04-17  |  5.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMPPPPRRRROOOOBBBBEEEE((((1111))))                                                          PPPPMMMMPPPPRRRROOOOBBBBEEEE((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmpppprrrroooobbbbeeee - lightweight probe for performance metrics
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppmmmmpppprrrroooobbbbeeee [----IIIIiiiiVVVVvvvv] [----aaaa _a_r_c_h_i_v_e] [----hhhh _h_o_s_t_n_a_m_e] [----nnnn _p_m_n_s_f_i_l_e] [_m_e_t_r_i_c_n_a_m_e ...]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      ppppmmmmpppprrrroooobbbbeeee determines the availability of performance metrics exported
  16.      through the facilities of the Performance Co-Pilot (PCP).
  17.  
  18.      The metrics of interest are named in the _m_e_t_r_i_c_n_a_m_e arguments.  If
  19.      _m_e_t_r_i_c_n_a_m_e is a non-leaf node in the Performance Metrics Name Space
  20.      (ppppmmmmnnnnssss(4)), then ppppmmmmpppprrrroooobbbbeeee will recursively descend the PMNS and report on
  21.      all leaf nodes.  If no _m_e_t_r_i_c_n_a_m_e argument is given, the root of the
  22.      namespace is used.
  23.  
  24.      The output format is spartan and intended for use in wrapper scripts
  25.      creating configuration files for other PCP tools.  By default, there is
  26.      one line of output per metric, with the metric name followed by a count
  27.      of the number of available values.  Error conditions are encoded as a
  28.      negative value count (as per the PPPPMMMMAAAAPPPPIIII(3) protocols, but may be decoded
  29.      using ppppmmmmeeeerrrrrrrr(1)) and followed by a textual description of the error.
  30.  
  31.      Unless directed to another host by the ----hhhh option, ppppmmmmpppprrrroooobbbbeeee will contact
  32.      the Performance Metrics Collector Daemon (PMCD) on the local host.
  33.  
  34.      The ----aaaa option causes ppppmmmmpppprrrroooobbbbeeee to use the specified archive rather than
  35.      connecting to a PMCD.  The ----aaaa and ----hhhh options are mutually exclusive.
  36.  
  37.      Normally ppppmmmmpppprrrroooobbbbeeee operates on the distributed Performance Metrics Name
  38.      Space (PMNS), however, if the ----nnnn option is specified an alternative local
  39.      PMNS file is loaded from the file _p_m_n_s_f_i_l_e.
  40.  
  41.      Other options control the output of additional information when one or
  42.      more values is available.
  43.  
  44.      ----IIII   Report the external identifiers for each instance.  The literal
  45.           string PPPPMMMM____IIIINNNN____NNNNUUUULLLLLLLL is reported for singular metrics.
  46.  
  47.      ----iiii   Report the internal identifiers for each instance.  The values are
  48.           in decimal and prefixed by ``?''.  As a special case, the literal
  49.           string PPPPMMMM____IIIINNNN____NNNNUUUULLLLLLLL is reported for singular metrics.
  50.  
  51.      ----vvvv   Report the value for each instance, as per the formatting rules of
  52.           ppppmmmmPPPPrrrriiiinnnnttttVVVVaaaalllluuuueeee(3).
  53.  
  54.      The ----vvvv option is mutually exclusive with either the ----IIII or ----iiii options.
  55.  
  56.      The ----VVVV option provides a cryptic summary of the number of messages sent
  57.      and received across the PMAPI interface.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMPPPPRRRROOOOBBBBEEEE((((1111))))                                                          PPPPMMMMPPPPRRRROOOOBBBBEEEE((((1111))))
  71.  
  72.  
  73.  
  74. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  75.      $ pmprobe disk.dev
  76.      disk.dev.read 2
  77.      disk.dev.write 2
  78.      disk.dev.total 2
  79.      disk.dev.blkread 2
  80.      disk.dev.blkwrite 2
  81.      disk.dev.blktotal 2
  82.      disk.dev.active 2
  83.      disk.dev.response 2
  84.  
  85.      $ pmprobe -I disk.dev.read disk.dev.write \
  86.        disk.all.total
  87.      disk.dev.read 2 "dks0d1" "dks0d2"
  88.      disk.dev.write 2 "dks0d1" "dks0d2"
  89.      disk.all.total 1 PM_IN_NULL
  90.  
  91.      $ pmprobe -v pmcd.numagents pmcd.version pmcd.control.timeout
  92.      pmcd.numagents 1 9
  93.      pmcd.version 1 "2.0 beta-1"
  94.      pmcd.control.timeout 1 5
  95.  
  96.      $ pmprobe -v disk.dev.total disk.all.total
  97.      disk.dev.total -1012 Unknown metric name
  98.      disk.all.total 1 4992466
  99.  
  100. FFFFIIIILLLLEEEESSSS
  101.      $$$$PPPPCCCCPPPP____VVVVAAAARRRR____DDDDIIIIRRRR////ppppmmmmnnnnssss////*     default PMNS specification files
  102.  
  103. PPPPCCCCPPPP EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  104.      Environment variables with the prefix PPPPCCCCPPPP____ are used to parameterize the
  105.      file and directory names used by PCP.  On each installation, the file
  106.      /_e_t_c/_p_c_p._c_o_n_f contains the local values for these variables.  The
  107.      $$$$PPPPCCCCPPPP____CCCCOOOONNNNFFFF variable may be used to specify an alternative configuration
  108.      file, as described in ppppccccpppp....ccccoooonnnnffff(4).
  109.  
  110. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  111.      PPPPCCCCPPPPIIIInnnnttttrrrroooo(1), ppppmmmmccccdddd(1), ppppmmmmcccchhhhaaaarrrrtttt(1), ppppmmmmdddduuuummmmpppplllloooogggg(1), ppppmmmmiiiinnnnffffoooo(1), PPPPMMMMAAAAPPPPIIII(3),
  112.      ppppmmmmEEEErrrrrrrrSSSSttttrrrr(3) and ppppmmmmnnnnssss(4).
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.